home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / ac.arc / AREACODE.DOC < prev   
Encoding:
Text File  |  1987-05-02  |  3.9 KB  |  127 lines
  1.  
  2.  
  3.  
  4.      AREACODE(1)                                           AREACODE(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           areacode - find areacodes and/or country codes by code or
  10.           location
  11.  
  12.      SYNOPSIS
  13.           areacode [ code ] [ city | state ] [ city, state ] [ - ]
  14.  
  15.      DESCRIPTION
  16.           Areacode finds areacodes and country codes either by numeric
  17.           code or location as follows:
  18.  
  19.           Argument strings are processed one per line.  They can be
  20.           entered either from the command line or from stdin (if
  21.           areacode is invoked with '-' as the only argument).  All
  22.           output is to stdout.
  23.  
  24.           If the first character of an argument string is numeric, the
  25.           string is assumed to represent an area/country code which is
  26.           checked against known codes.  If a match is found, the code
  27.           and the corresponding state, province, or country are
  28.           printed, followed by a list of known cities in that area,
  29.           and their city codes if required.
  30.  
  31.           If the first character is not numeric, and the string
  32.           contains no comma, the string is assumed to represent a city
  33.           or state/country or both, and all matches will be printed.
  34.           If there is a comma in the string, however, anything before
  35.           it is interpreted as a city, and anything after it is taken
  36.           to be a state, province, or country, in which case the
  37.           search will be restricted to matching states, provinces, or
  38.           countries.
  39.  
  40.           Alphabetic strings match if their beginning characters
  41.           match.  If the length of the string used in a 'state' search
  42.           is two, the string will match either the standard two-letter
  43.           abbreviation for that state or the first two characters of
  44.           its name.  Case is not significant.  Thus, 'ar' matches both
  45.           Arizona and Arkansas, 'AL' matches Alberta, Alabama, and
  46.           Alaska, while 'Ak' matches only Alaska.
  47.  
  48.           The following abbreviations (if directly followed by '.')
  49.           will be expanded before matches are attempted:
  50.  
  51.                st.  -> saint   sta. -> santa   ft.  -> fort
  52.                n.   -> north   no.  -> north   e.   -> east
  53.                s.   -> south   so.  -> south   w.   -> west
  54.  
  55.           If a state/province/country matches, but no city within that
  56.           area matches, the state/province/country name will be listed
  57.           followed by all codes for that area.  If there is a matching
  58.           city, however, it will be listed along with its
  59.           areacode/country code and city code (if required).
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/23/87)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      AREACODE(1)                                           AREACODE(1)
  71.  
  72.  
  73.  
  74.           Results of some example strings:
  75.  
  76.           609
  77.           New Jersey (NJ):  Atlantic City, Barnegat, Bellmawr,
  78.           Bridgeton, Burlington, Camden, Collingswood, Ewing, Fort
  79.           Dix, Glassboro, Gloucester, Haddonfield, Millville, Mount
  80.           Holly, Princeton, Trenton, Vineland, Wildwood, Woodbury
  81.  
  82.           Cal       - anything starting with 'cal'
  83.           California (CA): 209 213 408 415 619 707 714 805 818 916
  84.           Calumet City, Illinois (312)
  85.           Callicoon, New York (914)
  86.  
  87.           ,cal      - states starting with 'cal'
  88.           California (CA): 209 213 408 415 619 707 714 805 818 916
  89.  
  90.           Ft., N.   - 'Fort' cities in 'North' states
  91.           Fort Bragg, North Carolina (919)
  92.           North Dakota (ND): 701
  93.  
  94.           If at least one match is found, the program will exit with a
  95.           code of 0, otherwise it will exit with a code of 1.
  96.  
  97.           
  98.  
  99.           P.S. Renaming/linking the executable file to 'ac' saves
  100.           typing...
  101.  
  102.      AUTHOR
  103.           Skip Gilbrech
  104.  
  105.      SEE ALSO
  106.           The Phone Book
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.                                  
  124.  
  125.  
  126.  
  127.